home *** CD-ROM | disk | FTP | other *** search
/ Libris Britannia 4 / science library(b).zip / science library(b) / MUSIC / 4028.ZIP / GTRTLBOX.ZIP / MANUAL.TXT < prev    next >
Text File  |  1993-05-21  |  24KB  |  476 lines
  1.  
  2.  
  3.  
  4.                     G U I T A R I S T ' S   T O O L B O X
  5.  
  6.  
  7.                          Version 1.51s, May 18th 1993
  8.  
  9.  
  10.                       Copyright (c) By Paul Dettman 1993
  11.  
  12.  
  13.  
  14.  
  15.  
  16.               --------------------------------------------------
  17.                    P  R  O  G  R  A  M     M  A  N  U  A  L
  18.               --------------------------------------------------
  19.  
  20.                       C O P Y R I G H T     N O T I C E
  21.  
  22. Guitarist's Tooolbox consists of one executable file, three .DAT data files,
  23. and several .TXT files containing supporting documentation.  ALL of these
  24. files, except for the file VENDOR.TXT are the property of the author, and may
  25. not be modified or dis-assembled without the author's express permission.
  26. However, I (the author) give permission for SHAREWARE DEMO versions of
  27. Guitarist's Toolbox to be passed around freely, possibly for a small handling
  28. fee not exceeding £5.00 or its equivalent.  The only proviso for this is that
  29. Guitarist's Toolbox is disributed COMPLETE and with ALL the files mentioned in
  30. README.TXT.  REGISTERED VERSIONS of Guitarist's Toolbox are registered only to
  31. one person; this person may use Guitarist's Toolbox on his or any other
  32. computer providing only one of these computers is running Guitarist's Toolbox
  33. at any one time.  The registered user MUST NOT give copies of his REGISTERED
  34. version to anyone else.
  35.  
  36.  
  37.                        W A R R A N T Y     N O T I C E
  38.  
  39. This program is provided AS IS and WITHOUT any warranty, either EXPRESSED or
  40. IMPLIED, including, but not limited to, the implied warranties of
  41. MERCHANTABILITY and FITNESS FOR A PARTICULAR PURPOSE.  In case of PROBLEMS,
  42. YOU must assume the COST of all necessary servicing, repair, and correction.
  43. Under no circumstances will the author accept responsibility for the loss of
  44. data or damage to equipment sustained as a direct or indirect result of using
  45. this software.
  46.  
  47.  
  48.  
  49.                                C O N T E N T S
  50.  
  51.                   1 ..... Introduction
  52.  
  53.                   2 ..... The Shareware Principle
  54.  
  55.                   3 ..... The Menu System, Data Entry
  56.  
  57.                   4 ..... Module 1: Note Analysis
  58.  
  59.                   5 ..... Module 2: Key Signatures
  60.  
  61.                   6 ..... Module 3: Chord Shape Library
  62.  
  63.                   7 ..... Module 4: Scales Library
  64.  
  65.                   8 ..... About Guitarist's Toolbox
  66.  
  67.                   9 ..... On-line Help System
  68.  
  69.                  10 ..... Quitting
  70.  
  71.                  11 ..... Appendix: Trouble Shooting
  72.  
  73.  
  74.  
  75.     ======================================================================
  76.                             C H A P T E R   O N E
  77.  
  78.                                  Introduction
  79.     ======================================================================
  80.  
  81.     Guitarist's Toolbox represents several months of work resulting from
  82.     a conversation that I had with my guitar teacher.  Basically, he knew
  83.     a lot about the guitar (as guitar teachers do), and I knew very
  84.     little.  I know a lot about programming, but he knows very little.
  85.     So he suggested that I write a program to show keys and chords and
  86.     which notes belong to each key and chord.  I thought about this for a
  87.     few days, and then decided to give it a go.  I had no idea what would
  88.     happen, but eventually I cobbled together a routine that has now
  89.     become the Note Analysis module.  Within a few weeks, I had more and
  90.     more ideas and the program grew from there.  I polished it up, bought
  91.     a new C++ compiler so I could finish it off, wrote some accompanying
  92.     documentation, and you can now see the results for yourself.  I admit
  93.     that it is not really of commercial quality, but I think that in its
  94.     field (and for its price!), it is very useful and potentially very
  95.     powerful.
  96.  
  97.     The program is aimed at almost all guitar players.  Novice players
  98.     should find it useful as a learning tool, and more advanced players
  99.     should look upon it as a revision tool.  Acoustic players may not
  100.     find the Scales Library too useful, but apart from that, the program
  101.     is as much for Electric guitarists as it is for Acoustic players.
  102.     Also, you don't really need to know much about computers (or MS-DOS)
  103.     to use the program. Apart from a few basic commands such as running a
  104.     program, changing directory, copying files, and so on, you can get
  105.     away with almost no knowledge at all.  And once Toolbox is installed,
  106.     you just need to know how to run it; what could be simpler?
  107.  
  108.     So what is Guitarist's Toolbox?  Well it consists of a network of
  109.     menus from which you can choose various options.  There are currently
  110.     four main areas which I call 'Modules'.  There is a module called
  111.     'Note Analysis' which will tell you which notes belong in which key,
  112.     and which notes are present in which chords.  All the keys are
  113.     included, and most of the common chords as well. The second module,
  114.     'Key Signatures' is very simple but still useful.  You tell it how
  115.     many sharps or flats appear in the 'key signature' at the beginning
  116.     of a piece of music, and it replies with the key that the piece has
  117.     been written in.  Module three is the 'Chord Shape Library'.  This is
  118.     potentially the most useful section.  You can choose to display on
  119.     screen any chord shape from a list of hundreds. This is really a
  120.     computerised chord book but is much quicker than a standard book
  121.     because you can display any chord shape immediately.  If you decide
  122.     to register your version of the program, I will send you a vastly
  123.     extended chord shape library and a program that lets you add to the
  124.     library, making the possible list of chord shapes endless. The fourth
  125.     module is the 'Scales Library'. This is very similar to the chord
  126.     library, but there are fewer scales to choose from, and the diagram
  127.     is very different because the entire fretboard is shown on screen all
  128.     at once.  Again, if you register I will send you some extra scales
  129.     and a utility program to let you add even more.
  130.  
  131.     Guitarist's Toolbox also contains an On-line help system, with brief
  132.     instructions about each module so you can 'jog' your memory easily
  133.     without leaving the program to find this manual.
  134.  
  135.     I now suggest that you go away and 'fiddle' with the program to
  136.     familiarize yourself with it.  Anything you can't work out should be
  137.     looked up in this manual.  Working this way will reduce the often
  138.     lengthy and painful process of learning how to use some new software.
  139.     You may find it easiest to print this manual onto paper.  If you
  140.     don't have a printer then don't worry, this isn't essential.
  141.  
  142.     I reccommend that you at least read the next section, about the
  143.     principle of shareware, before too long.  Don't forget that you still
  144.     haven't paid me for the program, you have just covered the costs of
  145.     the shareware library (or the bulletin board) and earned the right to
  146.     test Toolbox for thirty (30) days.
  147.  
  148.  
  149.     ======================================================================
  150.                              C H A P T E R   TWO
  151.  
  152.                            The Shareware Principle
  153.     ======================================================================
  154.  
  155.     Guitarist's Toolbox is SHAREWARE.  This means that me, the author,
  156.     retains all copyright on the software but I allow it to be passed
  157.     around between friends, relatives and associates and to be
  158.     distributed through various mail order Shareware Libraries who may
  159.     ask for a handling charge.  This extends to Toolbox being disributed
  160.     through any bulletin boards.  Typically, this charge will be less
  161.     than £5.00.  You get to use the program for this small fee, but only
  162.     for a set time.  In this case it is thirty days.  After thirty days,
  163.     you are expected to pay the author for the privelege of using the
  164.     software unless you decide that you do not want to keep it, in which
  165.     case you owe nobody any money at all, but you must stop using the
  166.     program.  If you continue using it, then I make a charge of £9.99
  167.     including postage and various benefits.  These benefits are described
  168.     in detail in the file REGISTER.TXT.  I cannot stress how important it
  169.     is that you register the program if you like it.  If nobody registers
  170.     the program, then I can only assume that nobody uses it and there is
  171.     therefore no reason for me to continue supporting and improving the
  172.     software.  So you see, if you register, you are making further
  173.     versions of the software possible.  Let me tell you, if I receive
  174.     just one registration then I will at least know that somebody
  175.     somewhere likes what I am doing.
  176.  
  177.     PLEASE REGISTER IF YOU FIND THIS PROGRAM USEFUL!!!
  178.  
  179.     Don't forget that this privelege of 'Try before you buy' software is
  180.     unique.  In no other situation will you be given this freedom.  You
  181.     will never be able to use a car for a month before you pay for it.
  182.     Even if you buy on credit, you are not being given the freedoms
  183.     associated with Shareware because there are interest charges
  184.     associated with credit, and you still have to pay sooner or later.
  185.     With Shareware, if you don't like it, you throw it away.  You do that
  186.     with a car you've bought on credit and you'll be in prison next week!
  187.  
  188.     To register this program, consult the REGISTER.TXT file for
  189.     information.  If you have a printer then you can print the file out,
  190.     cut off the order form, fill it in, and send it to me with your
  191.     remittance.  If you do not have a printer, then just write to me,
  192.     giving me all the information that you would have written on the
  193.     order form.  Please make sure the order form is filled in FULLY!
  194.  
  195.  
  196.     ======================================================================
  197.                           C H A P T E R   T H R E E
  198.  
  199.                          The Menu System, Data Entry
  200.     ======================================================================
  201.  
  202.     Guitarist's Toolbox has a very simple menu system to allow you to
  203.     access the various modules easily.  The menu consists of a list of
  204.     numbered options.  To select any of the options, just press the
  205.     appropriate number.  Simple, huh?
  206.  
  207.     Whenever you are expected to provide some information to the program,
  208.     for example, selecting a menu option or entering a response to a
  209.     question, you will be prompted with a line of RED text.  So don't
  210.     forget, wherever you see something written in RED then it is a
  211.     question or a prompt for you to answer.  In all situations other than
  212.     the menu system and for replying to YES/NO questions, you must press
  213.     <ENTER> after typing the required information before the program will
  214.     continue.  As a guide, whenever you need to give more than one letter
  215.     responses, you must press <ENTER> before Toolbox will accept the
  216.     information.
  217.  
  218.  
  219.     ======================================================================
  220.                            C H A P T E R   F O U R
  221.  
  222.                            Module 1: Note Analysis
  223.     ======================================================================
  224.  
  225.     This module was what started the ball rolling.  A brief introduction
  226.     to the module can be found in the main program.  You will first be
  227.     asked whether you are interested in major or minor keys and then
  228.     which key in particular you are interested in.  An important point to
  229.     note is that you are not strictly entering the letter of a key unless
  230.     you want to view the notes that make up the key, ie. menu option 3.
  231.     For all the other options, you are really entering the main letter of
  232.     a chord.  For example, if you want to know which notes make up a
  233.     chord of C major or C major 7 then you would answer 'MAJ' and 'C' to
  234.     the first two prompts.
  235.  
  236.     When you have passed these first two prompts, you will be shown the
  237.     main menu.  The first two options are in case you want to change your
  238.     answers to the first two prompts later on, ie. for selecting another
  239.     major or minor key or selecting a different key letter.  Use option 1
  240.     to keep the key letter but alternate between major and minor keys.
  241.     Use option 2 to stay in the current group but to change letters.  For
  242.     example, if you are currently in C Major, use option 1 to change to C
  243.     Minor, or option 2 to change to D Major.
  244.  
  245.     Option 3, as described above, will show you the 7 different notes
  246.     that make up your chosen key.  The other options will show which
  247.     notes make up various chord shapes that have the same main letter
  248.     which you have specified.
  249.  
  250.     Select option 12 to return to the main program menu when you have
  251.     finished.
  252.  
  253.  
  254.     ======================================================================
  255.                            C H A P T E R   F I V E
  256.  
  257.                            Module 2: Key Signatures
  258.     ======================================================================
  259.  
  260.     Although one of the simpler modules, this is one of the most useful
  261.     for the novice reader of music.  Any piece of music will have a 'Key
  262.     Signature'.  It looks like a series of '#' or 'b' marks just after the
  263.     clef but before the time signature.  This key signature indicates what
  264.     key the piece is written in, and hence which notes and chords are
  265.     most likely to appear in the music.
  266.  
  267.     Any particular key will have a set number of sharps ('#' signs) or
  268.     flats ('b' signs).  The number of sharps and flats, which may be zero,
  269.     indicates the key.  Therefore, the program will ask you first how many
  270.     sharps there are.  If you enter a number greater than zero then you
  271.     are told the corresponding key.  If you enter zero then you will be
  272.     asked how many flats there are and then told which key it is.
  273.  
  274.     After displaying the key, the program will ask whether you want to
  275.     find another key signature.  If you enter 'N' then you will be
  276.     returned to the main program menu.
  277.  
  278.  
  279.     ======================================================================
  280.                             C H A P T E R   S I X
  281.  
  282.                         Module 3: Chord Shape Library
  283.     ======================================================================
  284.  
  285.     This is the largest section of the program and is of use to every
  286.     guitarist who doesn't know by heart every single chord shape!
  287.  
  288.     You are first presented with a main menu with a series of numbers and
  289.     names of chords.  You can advance through the 'library' of chords by
  290.     pressing 'A' (followed by <ENTER>).  Step back through the library by
  291.     pressing 'B' (followed by <ENTER>).  Note that thirty chord titles
  292.     are visible at any one time, although the Shareware version only has
  293.     15 chord shapes in total.  Selecting the number of the chord shape
  294.     you require (and then pressing <ENTER>) will bring up a diagram of
  295.     that chord.  Note that although you can only see thirty titles at any
  296.     one time, you can request any chord shape, even if it is not
  297.     currently displayed.  Invalid selections (ie. numbers less than zero
  298.     or greater than the last chord) will be ignored.
  299.  
  300.     There are various points to note about a chord shape diagram.  Eight
  301.     frets of a guitar are drawn in the centre of the screen.  The top
  302.     fret will ususally be the first fret on the guitar, but a message on
  303.     the left will tell you whether or not this is actually the case.  The
  304.     frets on the diagram that correspond to the 3rd, 5th, 7th, 9th, 12th,
  305.     15th, 17th, 19th and 21st frets on the guitar are coloured brown. All
  306.     other frets are coloured yellow.  The three thicker strings represent
  307.     the three bass strings E, A and D.  If any of the strings are shown
  308.     as a dotted line, ie. 'broken' then that string does not form a part
  309.     of that particular chord shape and should not be played. Finger
  310.     positions over the frets are shown by white squares.  The finger
  311.     position representing the 'root' note of the chord is coloured green.
  312.     If the root note is actually an open string, then the whole string is
  313.     coloured green.  If there is a straight line of white squares, eg. if
  314.     every string is played at the sixth fret, then this chord is probably
  315.     a 'barre' chord and you should play these frets by laying out your
  316.     index finger across the neck of the guitar, and using your other
  317.     three fingers to make the remaining positions.
  318.  
  319.     When you have finished looking at a particular shape, press any key
  320.     to return to the library menu.  You may now make another selection,
  321.     or press 'C' followed by <ENTER> to return to the main program menu.
  322.  
  323.     If you own a registered version of the program, you will have a
  324.     separate utility called MAKSHAPE.BAT that you can use to add chord
  325.     shapes to the library.  This utility (and the associated MAKSHAP2.EXE
  326.     and supporting documentation) is available exclusively to registered
  327.     users of Guitarist's Toolbox.
  328.  
  329.  
  330.     ======================================================================
  331.                           C H A P T E R   S E V E N
  332.  
  333.                            Module 4: Scales Library
  334.     ======================================================================
  335.  
  336.     The scales library is similar in many ways to the chord library
  337.     covered earlier.  The menu system is identical, just select the
  338.     number of the scale you wish to view and press <ENTER>.
  339.  
  340.     The diagram uses the same symbols and colours, but all twenty-five
  341.     frets of a guitar are shown, running horizontally from left to right.
  342.  
  343.     When you have finished viewing a particular scale, just press any
  344.     key.  As in the chord library, 'C' followed by <ENTER> will return
  345.     you to the main program menu.
  346.            
  347.     Again, if you own a registered version of the program, you will have
  348.     a separate utility called MAKSCALE.BAT that you can use to add scales
  349.     to the library.  This utility (and the associated MAKSCAL2.EXE and
  350.     supporting documentation) is available exclusively to registered
  351.     users of Guitarist's Toolbox.
  352.  
  353.  
  354.     ======================================================================
  355.                         C H A P T E R   E I G H T
  356.  
  357.                         About Guitarist's Toolbox
  358.     ======================================================================
  359.  
  360.     This option gives out various messages and warnings agout the
  361.     program. It will vary depending on whether you are using the
  362.     Shareware version or a Registered version.  Registered Users get a
  363.     stunningly interesting screen with REGISTERED VERSION and their name
  364.     stamped somewhere.  The rest get politely reminded to register!!
  365.  
  366.  
  367.     ======================================================================
  368.                          C H A P T E R   N I N E
  369.  
  370.                            On-line Help System
  371.     ======================================================================
  372.  
  373.     The on-line help system for Guitarist's Toolbox is provided from a
  374.     file called INSTRUCT.DAT which must be stored in the SAME directory
  375.     to the main GUITAR.EXE program.  This file can only be read from
  376.     Guitarist's Toolbox.
  377.  
  378.     Main menu option 5 will take you into this module and you will then
  379.     be presented with the help menu.  Help is available for all four
  380.     modules, or you can press '5' to return to the main menu.
  381.  
  382.     Selecting any of the first four options will give a brief screen or
  383.     two of help on that module.  The help in this section is slightly
  384.     different to that found in this manual - use the manual in
  385.     conjunction with the on-line help, not instead of the on-line help.
  386.     When your chosen help section is displayed, you can press any key to
  387.     advance a page at a time through the file.  You can actually read
  388.     about any of the modules after and including the one you chose.  For
  389.     example, if you choose option 2, you can read about any of the last
  390.     three modules.  Choosing option 1 allows you to read the entire help
  391.     file.
  392.  
  393.     Pressing 'Q' at any time will return you to the help menu, and you
  394.     will be returned to the help menu automatically when you have seen
  395.     the whole file.  There is no need to press <ENTER> anywhere in the
  396.     help section - a single keypress is enough.
  397.  
  398.  
  399.     ======================================================================
  400.                           C H A P T E R   T E N
  401.  
  402.                                  Quitting
  403.     ======================================================================
  404.  
  405.     To leave Guitarist's Toolbox, return to the main menu from whichever
  406.     module you are currently using and choose option 7.  The screen will
  407.     clear and a message will appear.  There will be a different message
  408.     for the Shareware and Registered versions.  Shareware users will be
  409.     asked to register, and registered users will be thanked for their
  410.     generosity.
  411.  
  412.  
  413.     ======================================================================
  414.                        C H A P T E R   E L E V E N
  415.  
  416.                         Appendix: Trouble Shooting
  417.     ======================================================================
  418.  
  419.     Guitarist's Toolbox has been tested thoroughly on my computer.  I
  420.     cannot guarantee that it will work on anybody else's, but I can give
  421.     you some helpful hints if you are having trouble.  I suggest you work
  422.     down the list from top to bottom.  Here goes...
  423.  
  424.             ■ You do not need a hard disk, although one is reccommended.
  425.               Toolbox will run much slower from a floppy disk, but WILL
  426.               work.
  427.  
  428.             ■ Make sure you have a copy of MS-DOS version 3.0 or higher,
  429.               or alternatively a copy of DR DOS.  I have tested this
  430.               program with MS-DOS version 5.
  431.            
  432.             ■ Make sure ANSI.SYS is loaded.  Your CONFIG.SYS file may need a
  433.               line adding that looks something like this,
  434.  
  435.                 DEVICE=C:\DOS\ANSI.SYS
  436.  
  437.               Check your DOS reference manual for more details.
  438.  
  439.             ■ Also check that you have an EGA graphics card or higher.
  440.               Toolbox also works fine with my Paradise SVGA card and
  441.               monitor.  Toolbox was designed to run on a colour system
  442.               and MIGHT not work on monochrome systems.
  443.  
  444.             ■ I have tested Toolbox on my 40MHz 386 DX system but it
  445.               should work on any other processor from the 8086 to the
  446.               Intel Pentium!!!!  The program contains only 8086 code so
  447.               there should be no compatibility problems with other chips.
  448.  
  449.             ■ Make sure you have enough memory.  Toolbox uses very little
  450.               memory by today's standards, but you should have about
  451.               70K for the shareware version and no more than 150K for the
  452.               registered version.  This shouldn't be a problem for
  453.               anybody, but use the DOS 'mem' command to check out what
  454.               you have available.
  455.  
  456.             ■ Make sure that ALL of the following Toolbox files are in
  457.               the same directory as GUITAR.EXE and that you are in this
  458.               directory whenever you run the program.  That is, do not
  459.               put the path of GUITAR.EXE in the PATH command in your
  460.               autoexec.bat file.
  461.  
  462.               The necessary files are: GUITAR.EXE, INSTRUCT.DAT,
  463.               CRDSHAPE.DAT, SCALES.DAT.
  464.  
  465.             ■ Look at the file REGISTER.TXT for details of a special
  466.               offer.  I will look at your files and disk to see if either
  467.               are damaged.  The charge (which includes postage, handling,
  468.               and a free replacement disk if necessary) is very
  469.               reasonable.  This option should be used as a last resort;
  470.               try contacting the shareware library first, or (if you got
  471.               the files from a bulletin board), download them again to
  472.               make sure they didin't get damaged on the way.
  473.  
  474.  
  475.  
  476.